/*
 * Copyright 2020-2030 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
*/

package com.gitee.minimalismstyle.fresh.flowable.api.feign

import org.springframework.web.bind.annotation.*
import com.gitee.minimalismstyle.fresh.common.core.domain.R
import com.gitee.minimalismstyle.fresh.flowable.api.annotation.FlowableClient
import com.gitee.minimalismstyle.fresh.flowable.api.config.FlowableFeignConfig
import com.gitee.minimalismstyle.fresh.flowable.api.feign.model.RestIdentityLink

/**
 * TaskIdentityLinks
 * @author maoxiaodong
 */
@FlowableClient(configuration = [FlowableFeignConfig::class])
interface TaskIdentityLinksApi {


    /**
     * List identity links for a task
     */
    @GetMapping("/runtime/tasks/{taskId}/identitylinks")
    fun listTasksInstanceIdentityLinks(
        @PathVariable("taskId") taskId: String
    ): R<Any>

    /**
     * It is possible to add either a user or a group.
     */
    @PostMapping("/runtime/tasks/{taskId}/identitylinks")
    fun createTaskInstanceIdentityLinks(
        @PathVariable("taskId") taskId: String,
        @RequestBody(required = false) body: RestIdentityLink?
    ): R<RestIdentityLink>

    /**
     * Returns only identity links targeting either users or groups. Response body and status-codes are exactly the same as when getting the full list of identity links for a task.
     */
    @GetMapping("/runtime/tasks/{taskId}/identitylinks/{family}")
    fun listIdentityLinksForFamily(
        @PathVariable("taskId") taskId: String,
        @PathVariable("family") family: String
    ): R<Any>

    /**
     * Get a single identity link on a task
     */
    @GetMapping("/runtime/tasks/{taskId}/identitylinks/{family}/{identityId}/{type}")
    fun getTaskInstanceIdentityLinks(
        @PathVariable("taskId") taskId: String,
        @PathVariable("family") family: String,
        @PathVariable("identityId") identityId: String,
        @PathVariable("type") type: String
    ): R<RestIdentityLink>

    /**
     * Delete an identity link on a task
     */
    @DeleteMapping("/runtime/tasks/{taskId}/identitylinks/{family}/{identityId}/{type}")
    fun deleteTaskInstanceIdentityLinks(
        @PathVariable("taskId") taskId: String,
        @PathVariable("family") family: String,
        @PathVariable("identityId") identityId: String,
        @PathVariable("type") type: String
    ): R<Any>
}